home *** CD-ROM | disk | FTP | other *** search
/ Suzy B Software 2 / Suzy B Software CD-ROM 2 (1994).iso / bootup / boot_a2m / movpic20 / movpic20.asc < prev    next >
Text File  |  1995-05-02  |  9KB  |  201 lines
  1.  
  2.                          o o o o o o o o o o o o o o o
  3.                        o                               o
  4.                        o     Moving Pictures v2.0      o
  5.                        o  Saturday, February 20, 1993  o
  6.                        o  By Terry May @ Shark Bytes   o
  7.                        o                               o
  8.                          o o o o o o o o o o o o o o o
  9.  
  10.  
  11. VERSIONS:
  12.  
  13.      1.0 30-Mar-92 ... Original release!
  14.  
  15.      1.1 01-Jul-92 ... Support for Degas Elite (.PC?) background pics
  16.                        dropped in favor of the smaller Tiny (.TN?) format.
  17.  
  18.      1.2 28-Jan-93 ... Added support for Extend-O-Save (.EXT) files.
  19.  
  20.      2.0 20-Feb-93 ... No longer tied to specific file types.  Now
  21.                        the user supplies file types with MOVEPICS.LST!
  22.                        The possibilities are endless!  :^)
  23.  
  24.  
  25. INTRODUCTION:
  26.  
  27.      Moving Pictures came about while I was beta testing Warp 9 v3.5 from
  28.      CodeHead Technologies.  Background pics on my ST was a new
  29.      experience, and I found it really added a lot to my computing
  30.      environment.  My only complaint was that I had the same background
  31.      pic each time I booted up, unless I manually renamed another pic.  I
  32.      decided random background pics would be much more enjoyable, and
  33.      thus, Moving Pictures was born.
  34.  
  35.      Moving Pictures was initially designed to randomize Warp 9
  36.      background pics and Desk Manager startup pics, and was tied
  37.      specifically to these file types.  Then along came Warp 9
  38.      Extend-O-Save, and I thought it would be neat to have random screen
  39.      savers.  Well, then came Mandala, and I decided it would be neat to
  40.      have random palettes for IT!
  41.  
  42.      Obviously, I like a little variety in my life, but it was becoming a
  43.      bit ridiculous to keep updating Moving Pictures for every time a new
  44.      file type came out that I wanted to randomize.  I decided it was
  45.      time to make Moving Pictures more flexible, to easily handle not
  46.      only all current file types I want to randomize, but any future
  47.      ones, as well.  And so, I updated Moving Pictures to v2.0 for
  48.      exactly this purpose.  It will now randomize not only all your
  49.      pictures, but anything else you like!
  50.  
  51.  
  52. INSTALLATION:
  53.  
  54.      First, copy MOVEPICS.PRG to your AUTO folder.  It can be placed
  55.      anywhere in your AUTO folder, since it's not a TSR and doesn't do
  56.      anything with your memory or vectors.  I like to run it last, just
  57.      because it takes a couple seconds, allowing me to review the
  58.      messages from the programs that run before it.  :^)
  59.  
  60.      Second, create an ASCII file called MOVEPICS.CTL (a sample is
  61.      included) and also place it in your AUTO folder.  Again, order is
  62.      unimportant.  Each line in this file MUST follow a strict format, as
  63.      follows:
  64.  
  65.      Source path\filespec starting in the first column, followed by
  66.      EXACTLY ONE SPACE, followed by the destination path\filename.  The
  67.      source path\filespec MUST contain some type of wildcard, e.g.,
  68.      C:\Pics\*.TN1.  The destination path\filename MUST contain the EXACT
  69.      filename you want for your destination file.  Both source and
  70.      destination MUST contain full paths.  Case is unimportant.
  71.  
  72.      The source should be the folder containing all the files you wish to
  73.      randomize.  The destination should be the exact filename needed by
  74.      the program that uses that file.
  75.  
  76.      IMPORTANT:  Both source and destination MUST be on the same drive.
  77.      There is no check for this, so you WILL get an error if your source
  78.      and destination are on different drives.  The reason for this is
  79.      because Moving Pictures actually renames your files for optimum
  80.      speed, and this is not possible between different drives.  They
  81.      DON'T have to be in the same folder, however.
  82.  
  83.      Here are some examples of _good_ MOVEPICS.CTL entries:
  84.  
  85. C:\Auto\DeskMgr\*.SPC C:\Auto\DeskMgr\DeskMgr.SPC
  86. C:\Auto\Pictures\*.TN2 C:\Auto\Pictures\STmedium.TN2
  87. C:\Pictures\*.TN3 C:\Warp_9\SThigh.TN3
  88. C:\Prism\*.PN5 C:\Auto\Warp_9\TTmedium.PNT
  89.  
  90.      Here are some examples of _bad_ MOVEPICS.CTL entries:
  91.  
  92. C:\Auto\DeskMgr\*.SPC  C:\Auto\DeskMgr\DeskMgr.SPC
  93.  C:\Auto\Pictures\*.TN2 C:\Auto\Pictures\STmedium.TN2
  94. C:\Auto\Pictures\SThigh.TN3 C:\Auto\Pictures\*.TN3
  95. D:\Pictures\*.PC3 C:\Warp_9\SThigh.PC3
  96.  
  97.      The first line has an extra space between source and destination.
  98.      The second line has a space at the beginning of the line.
  99.      The third line has source and destination backwards.
  100.      The fourth line has different source and destination drives.
  101.  
  102.  
  103. MOVEPICS.LST:
  104.  
  105.      Moving Pictures creates an ASCII file called MOVEPICS.LST in your
  106.      AUTO folder.  This file contains a list of the files it has renamed.
  107.      The list is in the following format:
  108.  
  109. C:\AUTO\WARP_9\STMEDIUM.TN2 C:\PICTURES\SHARK.TN2
  110.  
  111.      The first path\filename is the file as it is named now.  The second
  112.      path\filename is the original path\filename.
  113.  
  114.      Each time Moving Pictures runs, it looks for MOVEPICS.LST in your
  115.      AUTO folder and uses it to rename all your files back to their
  116.      original path\filenames.  It then proceeds to randomize your files
  117.      using your MOVEPICS.CTL file and then creates a new MOVEPICS.LST.
  118.  
  119.      If you change your MOVEPICS.CTL file, that's perfectly fine.  It will
  120.      have no effect whatsoever on Moving Pictures ability to process your
  121.      MOVEPICS.LST.
  122.  
  123.  
  124. TROUBLESHOOTING:
  125.  
  126.      About the only way to screw up Moving Pictures is to move or rename
  127.      the files in that MOVEPICS.LST, or to have your MOVEPICS.LST lost or
  128.      corrupted somehow.
  129.  
  130.      If you encounter an error, check your MOVEPICS.LST and make sure it
  131.      is not corrupted.  If everything looks ok, check each line and
  132.      ensure that the SECOND path\filename does not already exist.  If it
  133.      does, you'll have to delete that line from your MOVEPICS.LST, as
  134.      there is no way for Moving Pictures to rename a file to a
  135.      destination file that already exists!
  136.  
  137.      If you somehow lost your MOVEPICS.LST, you'll have to go through
  138.      each SECOND path\filename in your MOVEPICS.CTL file, and make sure
  139.      the path\filename does not already exist, for the same exact reason
  140.      outlined above.  If so, you'll have to rename the file back to its
  141.      original filename.
  142.  
  143.      I may eventually put in some error trapping to check for existance
  144.      of the destination path\filenames, but I don't want to bog the
  145.      program down anymore than I have to.  The program needs to be as
  146.      fast as possible, and so the user must assume a little
  147.      responsibility for proper operation.
  148.  
  149.      If you get the same destination files two or more times in a row,
  150.      don't worry.  Your previous destination file goes back into the pool
  151.      to be randomized and could very well come up again.  The more files
  152.      you have in your source folder, the less likely this will happen,
  153.      and the greater the random effect.
  154.  
  155.  
  156. POSSIBLE USES:
  157.  
  158.      Just about anything!  Warp 9 background pics (of ANY flavor now!);
  159.      Warp 9 Extend-O-Save modules; palettes for the Mandala EOS module;
  160.      IMG files for the Soft-Sci module; Desk Manager startup pics; samples
  161.      for Dave Baggett's BEEP.PRG; etc.
  162.  
  163.      Anything that can use a variety of a file type can be enhanced by
  164.      Moving Pictures ability to randomize that file type.  The only limit
  165.      is your imagination (and all the other limits mentioned above. ;^)
  166.  
  167.  
  168. WARRANTY:
  169.  
  170.      There is none.  Neither myself, Terry May, nor Shark Bytes assume
  171.      any responsibility for the use or misuse of Moving Pictures.  Moving
  172.      Pictures is believed to be perfectly safe in every way, but you still
  173.      must USE IT AT YOUR OWN RISK.
  174.  
  175.      If you encounter any bugs, let me know and I'll do my best to fix
  176.      them, but I make no promises.  (Hey, it's FREE! ;^)  If you have any
  177.      comments or suggestions, those will be appreciated.
  178.  
  179.      My address is OUTRIDER on both GEnie and Delphi.  I can also be
  180.      contacted at The Rebel BBS @ 702/435-0786 (Outrider), or through
  181.      FidoNet @ 1:209/745.0, AtariNet @ 51:2/0.0 and NeST @ 90:300/1012.
  182.  
  183.  
  184. POSTCARDWARE:
  185.  
  186.      What?  PostCardWare?  Yep, if you use Moving Pictures, you are asked to 
  187.      send a postcard of your home town to the following address:
  188.  
  189.           Atari Envy Inc.
  190.           10871 1/2 Whipple Street
  191.           N. Hollywood, CA  91602
  192.  
  193.      Your postcard WILL be appreciated!
  194.  
  195.  
  196. COPYRIGHTS:
  197.  
  198.      "Moving Pictures" is a copyright of Shark Bytes.  It may be
  199.      distributed freely, provided it is accompanied by this documentation
  200.      in complete and unaltered form.
  201.